home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cato / Xm / XmSetProtocolHooks.z / XmSetProtocolHooks
Text File  |  1998-10-20  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss - A VendorShell function that allows pre
  10.           and post actions to be executed when a protocol message is
  11.           received from MWM
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////XXXXmmmm....hhhh>>>>
  15.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////PPPPrrrroooottttooooccccoooollllssss....hhhh>>>>
  16.  
  17.           vvvvooooiiiidddd XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss ((((_s_h_e_l_l, _p_r_o_p_e_r_t_y, _p_r_o_t_o_c_o_l, _p_r_e_h_o_o_k, _p_r_e__c_l_o_s_u_r_e,
  18.                     _p_o_s_t_h_o_o_k, _p_o_s_t__c_l_o_s_u_r_e))))
  19.                WWWWiiiiddddggggeeeetttt         _s_h_e_l_l;;;;
  20.                AAAAttttoooommmm           _p_r_o_p_e_r_t_y;;;;
  21.                AAAAttttoooommmm           _p_r_o_t_o_c_o_l;;;;
  22.                XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkPPPPrrrroooocccc _p_r_e_h_o_o_k;;;;
  23.                XXXXttttPPPPooooiiiinnnntttteeeerrrr      _p_r_e__c_l_o_s_u_r_e;;;;
  24.                XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkPPPPrrrroooocccc _p_o_s_t_h_o_o_k;;;;
  25.                XXXXttttPPPPooooiiiinnnntttteeeerrrr      _p_o_s_t__c_l_o_s_u_r_e;;;;
  26.  
  27.           vvvvooooiiiidddd XXXXmmmmSSSSeeeettttWWWWMMMMPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss ((((_s_h_e_l_l, _p_r_o_t_o_c_o_l, _p_r_e_h_o_o_k, _p_r_e__c_l_o_s_u_r_e,
  28.                     _p_o_s_t_h_o_o_k, _p_o_s_t__c_l_o_s_u_r_e))))
  29.                WWWWiiiiddddggggeeeetttt         _s_h_e_l_l;;;;
  30.                AAAAttttoooommmm           _p_r_o_t_o_c_o_l;;;;
  31.                XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkPPPPrrrroooocccc _p_r_e_h_o_o_k;;;;
  32.                XXXXttttPPPPooooiiiinnnntttteeeerrrr      _p_r_e__c_l_o_s_u_r_e;;;;
  33.                XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkPPPPrrrroooocccc _p_o_s_t_h_o_o_k;;;;
  34.                XXXXttttPPPPooooiiiinnnntttteeeerrrr      _p_o_s_t__c_l_o_s_u_r_e;;;;
  35.  
  36.  
  37.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  38.           This page documents version 1.2 of the Motif library.
  39.  
  40.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  41.           XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss is used by shells that want to have pre
  42.           and post actions executed when a protocol message is
  43.           received from MWM.  Since there is no guaranteed ordering in
  44.           execution of event handlers or callback lists, this allows
  45.           the shell to control the flow while leaving the protocol
  46.           manager structures opaque.
  47.  
  48.           XXXXmmmmSSSSeeeettttWWWWMMMMPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss is a convenience interface.  It calls
  49.           XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss with the property value set to the atom
  50.           returned by interning WWWWMMMM____PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLLSSSS.
  51.  
  52.  
  53.           _s_h_e_l_l     Specifies the widget with which the protocol
  54.                     property is associated
  55.  
  56.           _p_r_o_p_e_r_t_y  Specifies the protocol property
  57.  
  58.           _p_r_o_t_o_c_o_l  Specifies the protocol atom (or an int cast to
  59.                     Atom)
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           _p_r_e_h_o_o_k   Specifies the procedure to call before calling
  75.                     entries on the client callback-list
  76.  
  77.           _p_r_e__c_l_o_s_u_r_e
  78.                     Specifies the client data to be passed to the
  79.                     prehook when it is invoked
  80.  
  81.           _p_o_s_t_h_o_o_k  Specifies the procedure to call after calling
  82.                     entries on the client callback-list
  83.  
  84.           _p_o_s_t__c_l_o_s_u_r_e
  85.                     Specifies the client data to be passed to the
  86.                     posthook when it is invoked
  87.  
  88.  
  89.           For a complete definition of VendorShell and its associated
  90.           resources, see VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll((((3333XXXX)))).
  91.  
  92.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  93.           VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll((((3333XXXX)))), XXXXmmmmIIIInnnntttteeeerrrrnnnnAAAAttttoooommmm((((3333XXXX)))), and
  94.           XXXXmmmmSSSSeeeettttWWWWMMMMPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX)))).
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.